Pular para o conteúdo principal

Localizar um elemento de UI (ui_element.find)

Esta função está disponível somente a partir da versão 20260507.

Declaração​

elemento, mensagem_de_erro = ui_element.find(seletor [, opcoes])

Parâmetros​

Valores retornados​

  • elemento
    Tabela; primeiro elemento de UI correspondente. nil em caso de falha.
  • mensagem_de_erro
    Texto; motivo da falha. Normalmente é "target not found" quando não há correspondência.

Descrição​

Se o seletor contiver index, retorna o elemento de número index entre os resultados correspondentes. Recomenda-se usar title ou text_contains junto com role para reduzir a ambiguidade causada por elementos com o mesmo nome.

Exemplo​

local ui_element = require("ui_element")

local item, err = ui_element.find({
title = "搜索",
role = "text_field",
})

if item then
ui_element.click(item)
else
sys.toast(err)
end

Observação: o código acima usa a função sys.toast, que não pertence a este capítulo.